W02-2. Docker 기본 - 실습 가이드

2주차 실습: 컨테이너 생명주기와 이미지 다루기

실습 목표 (45분)

  • 컨테이너를 만들고 → 켜고 → 얼리고 → 끄고 → 지우는 한 바퀴를 직접 돌린다.
  • stop 과 kill 의 차이를 시간과 종료 코드로 확인한다.
  • 로그 보기, 안에 들어가기, 정보 조회, 재시작 정책을 손에 익힌다.
  • 이미지의 CPU 종류, 레이어, 태그를 직접 들여다본다.

시작 전 확인

  • Docker Desktop 실행 중 (Engine running)
  • 터미널: macOS → 터미널 / Windows → PowerShell
  • 명령어는 macOS 와 Windows 가 똑같습니다. 다른 부분만 따로 표시했습니다.
  • 지난주 실습을 못 했다면 1주차 실습의 실습 1~3 만 먼저 해 보세요(10분).

실습 내용 시간
1 생명주기 한 바퀴 6분
2 stop vs kill 6분
3 메인 프로세스가 끝나면? 3분
4 로그 보기 6분
5 실행 중인 컨테이너 안 들여다보기 4분
6 컨테이너 정보 조회 3분
7 재시작 정책 5분
8 이미지 들여다보기 8분
9 디스크 사용량과 정리 4분

실습 1. 생명주기 한 바퀴

상태가 바뀔 때마다 docker ps -a 로 STATUS 를 확인하는 것이 핵심입니다.

1-1. 만들기만 하기 (Created)

docker create --name study-life -p 8080:80 nginx:1.30-alpine
docker ps -a --filter name=study-life

출력 예시:

CONTAINER ID   IMAGE               COMMAND                  CREATED         STATUS    PORTS     NAMES
a1b2c3d4e5f6   nginx:1.30-alpine   "/docker-entrypoint.…"   2 seconds ago   Created             study-life

--filter name=study-life 는 이름에 study-life 가 들어간 것만 보여 달라는 뜻입니다.
지금 http://localhost:8080 에 접속하면 연결되지 않습니다. 아직 실행 전이기 때문입니다.

1-2. 실행하기 (Running)

docker start study-life
docker ps -a --filter name=study-life

STATUS: Up 2 seconds

브라우저에서 http://localhost:8080 을 열면 Welcome to nginx! 가 보입니다.

1-3. 얼리기 (Paused)

docker pause study-life
docker ps -a --filter name=study-life

STATUS: Up 30 seconds (Paused)

브라우저에서 http://localhost:8080 을 새로고침해 보세요. 페이지가 계속 로딩 중으로 멈춰 있습니다. 프로세스가 얼어 있어서 응답을 못 하는 것입니다.

1-4. 녹이기 (Running)

docker unpause study-life

로딩 중이던 브라우저가 바로 페이지를 보여 줍니다. 얼어 있는 동안 들어온 요청을 녹자마자 처리한 것입니다.

1-5. 끄기 (Exited) → 다시 켜기

docker stop study-life
docker ps -a --filter name=study-life

STATUS: Exited (0) 2 seconds ago → 종료 코드 0, 정상 종료입니다.

docker start study-life
docker restart study-life
docker ps -a --filter name=study-life

STATUS: Up 1 second → restart 는 "끄고 다시 켜기" 입니다.

1-6. 지우기

실행 중인 컨테이너를 그냥 지우면 어떻게 될까요?

docker rm study-life

출력 예시:

Error response from daemon: cannot remove container "study-life": container is running: stop the container before removing or force remove

실수로 실행 중인 서비스를 지우지 않도록 Docker 가 막아 줍니다. 끄고 지우거나, -f 로 강제로 지웁니다.

docker rm -f study-life
docker ps -a --filter name=study-life

목록이 비어 있으면 완료입니다. ✅


실습 2. stop vs kill

신호를 잘 처리하는 nginx 와, 신호를 무시하는 sleep 을 비교합니다.

docker run -d --name study-web -p 8080:80 nginx:1.30-alpine
docker run -d --name study-sleeper alpine:3.24 sleep 3600

2-1. 둘 다 stop -t 5 로 꺼 보기

-t 5 는 "SIGTERM 을 보낸 뒤 최대 5초 기다리고, 그래도 안 꺼지면 강제 종료" 라는 뜻입니다.

macOS:

time docker stop -t 5 study-web
time docker stop -t 5 study-sleeper

Windows (PowerShell):

Measure-Command { docker stop -t 5 study-web } | Select-Object TotalSeconds
Measure-Command { docker stop -t 5 study-sleeper } | Select-Object TotalSeconds

출력 예시 (Windows):

TotalSeconds
------------
   0.4793079      ← nginx: 바로 꺼짐
   4.9166402      ← sleep: 5초를 꽉 채워 기다림

macOS 는 출력 끝의 … total 숫자를 보세요. nginx 는 1초 미만, sleep 은 약 5초입니다.

2-2. 종료 코드 비교

docker ps -a --filter name=study- --format "table {{.Names}}\t{{.Status}}"

출력 예시:

NAMES           STATUS
study-sleeper   Exited (137) 3 seconds ago
study-web       Exited (0) 8 seconds ago
컨테이너 걸린 시간 종료 코드 무슨 일이 있었나
study-web (nginx) 1초 미만 0 SIGTERM 을 받고 스스로 정리하고 종료
study-sleeper (sleep) 약 5초 137 SIGTERM 을 무시 → 5초 뒤 SIGKILL 로 강제 종료
--format 이 뭔가요?

docker ps 출력에서 원하는 열만 골라 보여 줍니다. table 을 붙이면 제목 줄도 같이 나옵니다.

2-3. kill 은 기다리지 않는다

docker start study-sleeper
docker kill study-sleeper
docker ps -a --filter name=study-sleeper --format "{{.Names}}: {{.Status}}"

출력 예시:

study-sleeper: Exited (137) Less than a second ago

kill 은 기다림 없이 즉시 강제 종료합니다. 운영 중인 서비스에는 먼저 stop 을 쓰세요.

정리합니다.

docker rm study-web study-sleeper

실습 3. 메인 프로세스가 끝나면?

docker run -d --name study-echo alpine:3.24 echo "hi"
docker run -d --name study-ubuntu-d ubuntu:26.04

2~3초 기다린 뒤 상태를 봅니다.

docker ps -a --filter name=study- --format "table {{.Names}}\t{{.Command}}\t{{.Status}}"

출력 예시:

NAMES            COMMAND       STATUS
study-ubuntu-d   "/bin/bash"   Exited (0) 3 seconds ago
study-echo       "echo hi"     Exited (0) 4 seconds ago
둘 다 바로 꺼졌습니다. 고장이 아닙니다!

  • study-echo: 메인 프로세스 echo hi 가 글자를 찍고 끝났으니 컨테이너도 끝
  • study-ubuntu-d: 메인 프로세스 bash 가 입력이 없어 할 일이 없으니 끝

꺼진 컨테이너라도 출력은 남아 있습니다.

docker logs study-echo

출력: hi

docker rm study-echo study-ubuntu-d

실습 4. 로그 보기

docker run -d --name study-web -p 8080:80 nginx:1.30-alpine

브라우저에서 아래 두 주소를 각각 2~3번씩 열어 봅니다.

4-1. 전체 로그

docker logs study-web

출력 예시 (뒷부분):

172.17.0.1 - - [01/Oct/2026:04:52:40 +0000] "GET / HTTP/1.1" 200 896 "-" "Mozilla/5.0 ..." "-"
2026/10/01 04:52:40 [error] 33#33: *4 open() "/usr/share/nginx/html/nothing" failed (2: No such file or directory), ...
172.17.0.1 - - [01/Oct/2026:04:52:40 +0000] "GET /nothing HTTP/1.1" 404 153 "-" "Mozilla/5.0 ..." "-"
로그에서 읽을 수 있는 것 예
누가 접속했나 172.17.0.1 (Docker 내부 네트워크를 거쳐 들어온 내 브라우저)
무엇을 요청했나 GET /, GET /nothing
결과는 200 (성공), 404 (없음)
에러 내용 [error] ... open() ... failed

4-2. 마지막 몇 줄만 / 시간 표시

docker logs --tail 2 study-web
docker logs -t --tail 1 study-web

출력 예시 (-t): 맨 앞에 Docker 가 기록한 시간이 붙습니다.

2026-10-01T04:52:40.830131446Z 172.17.0.1 - - [...] "GET /nothing HTTP/1.1" 404 153 ...

4-3. 실시간으로 보기

docker logs -f study-web

이 상태에서 브라우저를 새로고침하면 터미널에 로그가 바로바로 올라옵니다.
다 봤으면 Ctrl + C 로 빠져나옵니다. 컨테이너는 계속 실행 중입니다.

장애 대응의 첫 단계

컨테이너가 이상하면 제일 먼저 docker logs 를 봅니다. 대부분의 원인이 로그에 찍혀 있습니다.


실습 5. 실행 중인 컨테이너 안 들여다보기

docker exec 로, 실행 중인 study-web 안에서 명령을 실행합니다.

docker exec study-web nginx -v
docker exec study-web ls /usr/share/nginx/html
docker exec study-web env

출력 예시:

nginx version: nginx/1.30.5

50x.html
index.html

PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOSTNAME=1d976fe04eb5
NGINX_VERSION=1.30.5
...
이미지에 들어 있는 정보들

  • nginx -v: 이미지에 들어 있는 nginx 버전
  • ls /usr/share/nginx/html: 웹 페이지 파일이 있는 곳
  • env: 컨테이너의 환경 변수. 이미지를 만든 사람이 넣어 둔 값(NGINX_VERSION)이 보입니다. 환경 변수는 5주차부터 설정을 넘기는 데 씁니다.

셸로 들어가서 둘러볼 수도 있습니다. alpine 기반 이미지에는 bash 가 없어서 sh 를 씁니다.

docker exec -it study-web sh

컨테이너 안에서:

cat /etc/nginx/conf.d/default.conf
exit

exit 로 나와도 컨테이너는 계속 실행 중입니다. 메인 프로세스(nginx)가 아니라 추가로 띄운 셸만 끝났기 때문입니다.


실습 6. 컨테이너 정보 조회

docker inspect 는 컨테이너의 모든 설정과 상태를 보여 줍니다. 그대로 실행하면 매우 길어서, 필요한 값만 골라 봅니다.

docker inspect --format "{{.State.Status}}" study-web
docker inspect --format "{{.Config.Image}}" study-web
docker inspect --format "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" study-web
docker port study-web

출력 예시:

running
nginx:1.30-alpine
172.17.0.2
80/tcp -> 0.0.0.0:8080
80/tcp -> [::]:8080
명령 알 수 있는 것
.State.Status 현재 상태
.Config.Image 어떤 이미지로 만들었나
range .NetworkSettings.Networks 컨테이너의 내부 IP (3주차 네트워크에서 다시 봅니다)
docker port 바깥 포트와 컨테이너 포트의 연결
인터넷의 예전 자료를 보면

docker inspect --format "{{.NetworkSettings.IPAddress}}" 라는 명령이 많이 나옵니다. Docker 29 에서는 에러가 납니다.

template parsing error: ... map has no entry for key "IPAddress"

위처럼 range .NetworkSettings.Networks 를 쓰세요.

정리합니다.

docker rm -f study-web

실습 7. 재시작 정책

nginx 컨테이너 안에서 nginx -s stop 을 실행하면 메인 프로세스를 직접 끌 수 있습니다. 앱이 갑자기 죽는 상황을 흉내 내는 것입니다.

7-1. 재시작 정책 없음 (기본값)

docker run -d --name study-norestart nginx:1.30-alpine
docker exec study-norestart nginx -s stop

2~3초 기다린 뒤:

docker ps -a --filter name=study-norestart --format "{{.Names}}: {{.Status}}"

출력 예시: 죽은 채로 있습니다.

study-norestart: Exited (0) 2 seconds ago

7-2. unless-stopped

docker run -d --name study-restart --restart unless-stopped nginx:1.30-alpine
docker exec study-restart nginx -s stop

2~3초 기다린 뒤:

docker ps -a --filter name=study-restart --format "{{.Names}}: {{.Status}}"
docker inspect --format "RestartCount={{.RestartCount}}" study-restart

출력 예시: Docker 가 다시 살려 냈습니다.

study-restart: Up 3 seconds
RestartCount=1

7-3. 사람이 stop 한 것은 존중한다

docker stop study-restart

몇 초 기다린 뒤 다시 확인합니다.

docker ps -a --filter name=study-restart --format "{{.Names}}: {{.Status}}"

출력 예시: 이번에는 살아나지 않습니다.

study-restart: Exited (0) 5 seconds ago

정리합니다.

docker rm study-norestart study-restart

실습 8. 이미지 들여다보기

8-1. 새 이미지 받기

Apache 웹 서버 이미지를 받아 봅니다.

docker pull httpd:2.4-alpine

출력 예시 (끝부분):

Status: Downloaded newer image for httpd:2.4-alpine
docker.io/library/httpd:2.4-alpine

마지막 줄을 보세요. 우리가 쓴 httpd:2.4-alpine 의 전체 이름(docker.io/library/…)이 나옵니다.

8-2. 내 노트북용으로 받은 이미지의 CPU 종류

docker image inspect --format "OS={{.Os}} Arch={{.Architecture}} Layers={{len .RootFS.Layers}}" nginx:1.30-alpine

출력 예시:

노트북 출력
Windows / Intel Mac OS=linux Arch=amd64 Layers=8
Apple Silicon Mac OS=linux Arch=arm64 Layers=8

옆 사람과 비교해 보세요. 같은 이름의 이미지인데 CPU 종류가 다릅니다. (Layers 숫자는 CPU 종류에 따라 다를 수도 있습니다.)

8-3. 이 태그에 들어 있는 CPU 별 이미지 목록

macOS:

docker buildx imagetools inspect nginx:1.30-alpine | grep "Platform:"

Windows (PowerShell):

docker buildx imagetools inspect nginx:1.30-alpine | Select-String "Platform:"

출력 예시:

  Platform:    linux/amd64
  Platform:    unknown/unknown
  Platform:    linux/arm/v6
  Platform:    unknown/unknown
  Platform:    linux/arm/v7
  Platform:    unknown/unknown
  Platform:    linux/arm64/v8
  Platform:    unknown/unknown
  Platform:    linux/386
  ...
읽는 법

  • linux/amd64, linux/arm64/v8 처럼 생긴 줄이 CPU 별 이미지입니다. 태그 하나에 8가지가 들어 있습니다.
  • unknown/unknown 은 이미지가 아니라 어떻게 만들었는지에 대한 증명서(attestation)입니다. 무시해도 됩니다.

8-4. 이미지가 만들어진 과정 (레이어)

docker image history nginx:1.30-alpine

출력 예시 (앞부분):

IMAGE          CREATED      CREATED BY                                      SIZE      COMMENT
0985e772fb9f   8 days ago   RUN /bin/sh -c set -x     && apkArch="$(cat …   51.9MB    buildkit.dockerfile.v0
<missing>      8 days ago   ENV ACME_VERSION=0.4.1                          0B        buildkit.dockerfile.v0
...
<missing>      8 days ago   CMD ["nginx" "-g" "daemon off;"]                0B        buildkit.dockerfile.v0
<missing>      8 days ago   STOPSIGNAL SIGQUIT                              0B        buildkit.dockerfile.v0
<missing>      8 days ago   EXPOSE map[80/tcp:{}]                           0B        buildkit.dockerfile.v0
...
4주차 예고

CREATED BY 열이 이미지를 만든 명령어 한 줄 한 줄입니다. 이 명령어들을 모아 놓은 파일이 Dockerfile 입니다.
CMD ["nginx" "-g" "daemon off;"] 가 바로 이 이미지의 메인 프로세스입니다(실습 3).
STOPSIGNAL SIGQUIT 는 nginx 를 끌 때 SIGTERM 대신 nginx 가 좋아하는 신호를 보내라는 설정입니다. 실습 2에서 nginx 가 바로 꺼진 이유 중 하나입니다.

8-5. 태그 붙이기와 지우기

docker tag nginx:1.30-alpine study-nginx:mytag
docker image ls --filter reference=nginx:1.30-alpine --filter reference=study-nginx

출력 예시:

IMAGE               ID             DISK USAGE   CONTENT SIZE   EXTRA
nginx:1.30-alpine   0985e772fb9f       93.6MB           27MB
study-nginx:mytag   0985e772fb9f       93.6MB           27MB

EXTRA 열에 U 가 보이면 그 이미지를 쓰는(In Use) 컨테이너가 있다는 뜻입니다.

ID 가 똑같습니다

docker tag 는 이미지를 복사하는 게 아니라 이름표를 하나 더 붙이는 것입니다. 디스크를 더 쓰지 않습니다.

이름표를 떼어 냅니다.

docker image rm study-nginx:mytag

출력: Untagged: study-nginx:mytag → 이름표만 떨어지고, 원본 nginx:1.30-alpine 은 그대로입니다.

8-6. 쓰는 중인 이미지는 지울 수 없다

docker run -d --name study-httpd httpd:2.4-alpine
docker image rm httpd:2.4-alpine

출력 예시:

Error response from daemon: conflict: unable to delete httpd:2.4-alpine (must be forced) - container be43964d98d7 is using its referenced image 4e585da9d012

컨테이너를 먼저 지우면 이미지도 지울 수 있습니다.

docker rm -f study-httpd
docker image rm httpd:2.4-alpine

출력 예시:

Untagged: httpd:2.4-alpine
Deleted: sha256:4e585da9d0125dec36d4500a9f5c5df7b2c0a01f67cb47865a91a4b05bdbec1b

실습 9. 디스크 사용량과 정리

docker system df

출력 예시: 숫자는 사람마다 크게 다릅니다.

TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          5         0         280MB     280MB (100%)
Containers      0         0         0B        0B
Local Volumes   0         0         0B        0B
Build Cache     0         0         0B        0B
열 의미
TOTAL 전체 개수
ACTIVE 컨테이너가 쓰고 있는 개수
RECLAIMABLE 지우면 되찾을 수 있는 용량

오늘 만든 컨테이너 한 번에 정리

이름이 study- 로 시작하는 컨테이너만 골라 지웁니다.

docker rm -f $(docker ps -aq --filter name=study-)
docker ps -a --filter name=study-

목록이 비어 있으면 정리 끝입니다. ✅
이미지(nginx:1.30-alpine, alpine:3.24, ubuntu:26.04)는 다음 주에도 쓰니 지우지 않습니다.


자주 나는 문제와 해결

증상 원인 해결
docker run -d ubuntu:26.04 가 바로 Exited 메인 프로세스가 할 일이 없음 정상입니다(실습 3). 계속 띄우려면 sleep 3600 처럼 오래 도는 명령을 줍니다
docker exec -it ... bash 에서 executable file not found alpine 기반 이미지에는 bash 가 없음 sh 를 씁니다
docker logs -f 에서 빠져나올 수 없음 - Ctrl + C. 컨테이너는 계속 실행됩니다
cannot remove container ... container is running 실행 중인 컨테이너는 그냥 못 지움 docker stop 후 docker rm, 또는 docker rm -f
unable to delete ... container ... is using its referenced image 그 이미지로 만든 컨테이너가 남아 있음 (멈춘 것 포함) docker ps -a 로 찾아서 컨테이너부터 지움
map has no entry for key "IPAddress" 예전 자료의 명령(Docker 29 에서 바뀜) {{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}} 사용
Windows 에서 --format 결과가 이상함 Git Bash 사용 PowerShell 사용

오늘 쓴 명령어 정리

분류 명령어 하는 일
생명주기 docker create / start / stop / restart 만들기 / 켜기 / 끄기 / 재시작
docker pause / unpause 얼리기 / 녹이기
docker kill 즉시 강제 종료
docker stop -t 5 SIGTERM 후 최대 5초 기다림
조회 docker ps -a --filter name=... --format "..." 조건에 맞는 컨테이너만, 원하는 열만
docker logs [-f] [--tail N] [-t] 로그 보기
docker exec [-it] <이름> <명령> 실행 중인 컨테이너 안에서 명령 실행
docker inspect --format "{{...}}" 설정과 상태에서 원하는 값만
docker port <이름> 포트 연결 확인
운영 docker run --restart unless-stopped 죽으면 다시 켜기
이미지 docker pull / docker image ls 받기 / 목록
docker image inspect / docker image history 정보 / 만들어진 과정
docker buildx imagetools inspect 태그에 든 CPU 별 이미지 목록
docker tag / docker image rm 이름표 붙이기 / 떼기·삭제
정리 docker system df 디스크 사용량
docker rm -f $(docker ps -aq --filter name=study-) study- 컨테이너 한 번에 삭제

복습 과제

확인 퀴즈

  1. docker run 은 어떤 두 명령을 합친 것인가요?
  2. 실습 2에서 nginx 는 바로 꺼지고 sleep 은 5초가 걸렸습니다. 왜 그런가요? 종료 코드는 각각 무엇이었나요?
  3. docker run -d ubuntu:26.04 를 실행하면 컨테이너가 바로 Exited 가 됩니다. 이유는?
  4. --restart unless-stopped 로 띄운 컨테이너를 docker stop 으로 끄면 다시 살아나나요?
  5. docker tag nginx:1.30-alpine study-nginx:mytag 를 하면 디스크 사용량이 두 배가 되나요?
  6. Windows 노트북과 Apple Silicon Mac 이 같은 nginx:1.30-alpine 을 받았는데 CPU 종류가 다릅니다. 어떻게 가능한가요?

도전 과제 (선택)

  1. docker run -d --name study-oneshot --restart on-failure:3 alpine:3.24 sh -c "echo failed!; exit 1" 을 실행하고, 15초쯤 뒤에 아래를 확인해 보세요. 몇 번 다시 시도했나요? 왜 멈췄을까요?
    docker ps -a --filter name=study-oneshot --format "{{.Names}}: {{.Status}}"
    docker inspect --format "RestartCount={{.RestartCount}}" study-oneshot
    docker logs study-oneshot
    
  2. Docker Desktop 대시보드의 Images 화면에서 nginx:1.30-alpine 을 눌러 보세요. 오늘 터미널로 본 레이어 목록이 화면에도 나옵니다.
  3. 다 했으면 docker rm -f study-oneshot 으로 정리합니다.
다음 주 예고: 3주차 포트 · 볼륨 · 네트워크

지금까지는 컨테이너를 지우면 데이터가 사라졌고, 컨테이너끼리는 서로를 몰랐습니다.
다음 주에는 데이터를 컨테이너 밖에 보관하는 법(볼륨) 과 컨테이너끼리 이름으로 통신하는 법(네트워크) 을 배웁니다.


네비게이션

이전 목록 다음
◀ 2주차 강의 노트 목록으로 3주차 강의 노트 ▶